home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cato / Xm / XmClipboardInquireLength.z / XmClipboardInquireLength
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeLLLLeeeennnnggggtttthhhh((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeLLLLeeeennnnggggtttthhhh((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeLLLLeeeennnnggggtttthhhh - A clipboard function that returns
  10.           the length of the stored data
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////CCCCuuuuttttPPPPaaaasssstttteeee....hhhh>>>>
  15.  
  16.           iiiinnnntttt XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeLLLLeeeennnnggggtttthhhh ((((_d_i_s_p_l_a_y, _w_i_n_d_o_w, _f_o_r_m_a_t__n_a_m_e, _l_e_n_g_t_h))))
  17.                DDDDiiiissssppppllllaaaayyyy   * _d_i_s_p_l_a_y;;;;
  18.                WWWWiiiinnnnddddoooowwww    _w_i_n_d_o_w;;;;
  19.                cccchhhhaaaarrrr      * _f_o_r_m_a_t__n_a_m_e;;;;
  20.                uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg* _l_e_n_g_t_h;;;;
  21.  
  22.  
  23.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  24.           This page documents version 1.2 of the Motif library.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeLLLLeeeennnnggggtttthhhh returns the length of the data
  28.           stored under a specified format name for the clipboard data
  29.           item.  If no data is found for the specified format, or if
  30.           there is no item on the clipboard, this function returns a
  31.           value of zero.
  32.  
  33.           Any format passed by name is assumed to have the _l_e_n_g_t_h
  34.           passed in a call to XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddCCCCooooppppyyyy, even though the data
  35.           has not yet been transferred to the clipboard in that
  36.           format.
  37.  
  38.  
  39.           _d_i_s_p_l_a_y     Specifies a pointer to the DDDDiiiissssppppllllaaaayyyy structure
  40.                       that was returned in a previous call to
  41.                       XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy or XXXXttttDDDDiiiissssppppllllaaaayyyy.
  42.  
  43.           _w_i_n_d_o_w      Specifies a widget's window ID that relates the
  44.                       application window to the clipboard.  The
  45.                       widget's window ID can be obtained by using
  46.                       XXXXttttWWWWiiiinnnnddddoooowwww.  The same application instance should
  47.                       pass the same window ID to each of the clipboard
  48.                       functions that it calls.
  49.  
  50.           _f_o_r_m_a_t__n_a_m_e Specifies the name of the format for the data
  51.                       item.
  52.  
  53.           _l_e_n_g_t_h      Specifies the length of the next data item in
  54.                       the specified format.  This argument equals zero
  55.                       if no data is found for the specified format, or
  56.                       if there is no item on the clipboard.
  57.  
  58.  
  59.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  60.  
  61.  
  62.  
  63.      PPPPaaaaggggeeee 1111                                          ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888))))
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeLLLLeeeennnnggggtttthhhh((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeLLLLeeeennnnggggtttthhhh((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           CCCClllliiiippppbbbbooooaaaarrrrddddSSSSuuuucccccccceeeessssssss
  75.                       The function is successful.
  76.  
  77.           CCCClllliiiippppbbbbooooaaaarrrrddddLLLLoooocccckkkkeeeedddd
  78.                       The function failed because the clipboard was
  79.                       locked by another application.  The application
  80.                       can continue to call the function again with the
  81.                       same parameters until the lock goes away.  This
  82.                       gives the application the opportunity to ask if
  83.                       the user wants to keep trying or to give up on
  84.                       the operation.
  85.  
  86.           CCCClllliiiippppbbbbooooaaaarrrrddddNNNNooooDDDDaaaattttaaaa
  87.                       The function could not find data on the
  88.                       clipboard corresponding to the format requested.
  89.                       This could occur because the clipboard is empty;
  90.                       there is data on the clipboard but not in the
  91.                       requested format; or the data in the requested
  92.                       format was passed by name and is no longer
  93.                       available.
  94.  
  95.  
  96.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  97.           XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddCCCCooooppppyyyy((((3333XXXX)))) and XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddSSSSttttaaaarrrrttttCCCCooooppppyyyy((((3333XXXX)))).
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.